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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



,ixl , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; Configuration Management (CM), as identified 
below: 

32.311: "Generic Integration Reference Point (IRP) management; Requirements"; 

32.312: "Generic Integration Reference Point (IRP) management; Information Service (IS)"; 

32.313: "Generic Integration Reference Point (IRP) management; Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)"; 

32.314: 'Generic Integration Reference Point (IRP) management; Common Management Information 

Protocol (CMIP) Solution Set (SS)"; 
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Scope 



The present document specifies the CORBA Solution Set (SS) for Generic Integration Reference Point (IRP) 
management whose capabilities are specified in Generic Integration Reference (IRP) management: Information 

Service (IS) (TS 32.312 [1]). 

This Solution Set specification is related to TS 32.312 V6.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[2] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[3] 3GPP TS 32.1 1 1-2: "Telecommunication management; Alarm Integration Reference Point (IRP); 

Information Service (IS)". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.312 [1] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.311 [2] subclause 3.1. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

IOC Information Object Class 

OMG Object Management Group 

SS Solution Set 
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4 Architectural Features 

The overall architectural feature of this IRP is specified in 3G TS 32.312 [1]. This clause specifies features that are 
specific to the CORBA SS. 

Abstract IOC 

The capabilities of the Generic IRP management: IS [1] are captured by the definition of an IOC called 
ManagedGenericIRP. This IOC is an abstract class and is mapped to a MOC of the same name. The MOC is intended 
for inheritance by other MOCs specified in Interface IRPs such as AlarmIRP [3], NotificationIRP [4], etc. 



5. Mapping 

5.1 Operation mapping 

Generic IRP management: IS [1] defines semantics of operation visible across the Itf-N. Table 1 indicates mapping of 
these operations to their equivalents defined in this SS. 

Table 5.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation TS 32.312 [1] 


SS Method 


Qualifier 


getlRPVersion 


get IRP versions 


M 


getOperationProfile 


get interface IRP operation profile 





getNotificationProfile 


get interface IRP notification profile 






5.2 Operation parameter mapping 

Generic IRP management: IS [1] defines semantics of parameters carried in operations across the Itf-N. The following 
set of tables indicates the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2 Mapping from IS getlRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type 
GenericlRPManagementConstDefs::VersionNumberSet 


M 


status 


Exceptions: 
GenericlRPManagementSystem::GetlRPVersions 


M 



Table 5.3 Mapping from IS getOperationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


GenericlRPManagementConstDefs::VersionNumber 
this IRP version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type 
GenericlRPManagementConstDefs::MethodList 


M 


status 


Exceptions: 

GenericlRPManagementSystem 

::GetlnterfacelRPOperationsProfile, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem ::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported 


M 
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Table 5.4 Mapping from IS getNotif icationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


GenericlRPManagementConstDefs::VersionNumber 
this IRP version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type GenericlRPManagementConstDefs 
::NotificationList 


M 


status 


Exceptions: 

GenericlRPManagementSystem 

::GetlnterfacelRPNotificationProfile, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem ::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported 


M 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

'GenericlRPManagementConstDefs.idl') 

//File : GenericIRPManagementConstDef s . idl 

#ifndef _GENERICIRPMANAGEMENTCONSTDEFS_IDL_ 
#define _GENERICIRPMANAGEMENTCONSTDEFS_IDL_ 

#include "TimeBase . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: GenericIRPManagementConstDef s 

This module contains definitions commonly used among all IRPs. 

*/ 

module GenericIRPManagementConstDef s 
{ 

/* 

Definition imported from CosTime. 

The time refers to time in Greenwich Time Zone. 

It also consists of a time displacement factor in the form of minutes of 

displacement from the Greenwich Meridian. 

*/ 

typedef TimeBase :: UtcT IRPTime; 

enum Signal {OK, FAILURE, PARTIALFAILURE } ; 

/* 

The VersionNumber is a string that identifies the IRP specification name 
and its version number. See definition "IRP document version number 
string" or " IRPVersion" . 

The VersionNumberSet is a sequence of such VersionNumber. It is returned 

by get_XXX_IRP_versions ( ) . The sequence order has no significance. 

*/ 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 

typedef string MethodName; 

typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList ; 

/* 

The Method defines the structure to be returned as part of 

get_supported_operations_prof ile ( ) . The name shall be the actual method 

name (ex. "attach_push", "change_subscription_f ilter", etc.) 

The parameter_list contains a list of strings. Each string shall be 

the actual parameter name (ex. "manager_reference", "filter", etc.) 

*/ 

struct Method 

{ 
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MethodName name; 
ParameterList parameter_list ; 
}; 

/* 

List of all methods and their associated parameters. 

*/ 

typedef sequence <Method> MethodList; 

typedef string Notif icationName; 

struct Notification 

{ 

Notif icationName name; 

ParameterList parameter_list ; 
}; 
typedef sequence <Notif ication> Notif icationList; 

/* 

StringTypeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent. 

*/ 

union StringTypeOpt switch (boolean) 

{ 

case TRUE: string value; 

}; 

/* 

ShortTypeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent. 

*/ 

union ShortTypeOpt switch (boolean) 

{ 

case TRUE: short value; 
}; 

/* 

UnsignedShortTypeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent. 

*/ 

union UnsignedShortTypeOpt switch (boolean) 

{ 

case TRUE: unsigned short value; 

}; 

/* 

LongTypeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent. 

*/ 

union LongTypeOpt switch (boolean) 

{ 

case TRUE: long value; 

}; 

/* 

UnsignedLongTypeOpt is a type carrying an optional parameter. 

If the boolean is TRUE, then the value is present. 

Otherwise the value is absent. 

*/ 

union UnsignedLongTypeOpt switch (boolean) 
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{ 

case TRUE: unsigned long value; 

}; 
}; 

#endif _GENERICIRPMANAGEMENTCONSTDEFS_IDL_ 
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A.2 IDL specification (file name 

'GenericlRPManagementSystem.idr) 

//File : GenericIRPManagementSystem. idl 

#ifndef _GENERICIRPMANAGEMENTSYSTEM_IDL_ 
#define _GENERICIRPMANAGEMENTSYSTEM_IDL_ 

#include "GenericIRPManagementConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module GenericIRPManagementSystem 
{ 

exception Getlnterf acelRPNotif icationProf ile { string reason; }; 

exception Getlnterf acelRPOperationProf ile { string reason; }; 

exception GetlRPVersions { string reason; }; 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name. 

*/ 

exception ParameterNotSupported { 

GenericIRPManagementConstDef s :: ParameterName parameter; }; 

/* 

Exception thrown when an invalid parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception InvalidParameter { 

GenericIRPManagementConstDef s :: ParameterName parameter; }; 

/* 

Exception thrown when a valid but unsupported parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception ValueNotSupported { 

GenericIRPManagementConstDef s :: ParameterName parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

*/ 

exception OperationNotSupported {}; 

interface GenericIRPManagement 
{ 

/* 

Return the list of all supported Interface IRP versions 

Each IRPVersion is defined by the rule in the definition 

"IRP document version number string" or "IRPVersion" 

(see subclause 3.1). 

*/ 

GenericIRPManagementConstDef s : : VersionNumberSet get_IRP_versions 

( 

) 

raises (GetlRPVersions); 



ETSI 



3GPP TS 32.31 3 version 6.0.0 Release 6 1 2 ETSI TS 1 32 31 3 V6.0.0 (2004-1 2) 



/* 

Return the list of all supported methods and their supported 

parameters for this Interface IRPVersion. 

*/ 

GenericIRPManagementConstDef s : :MethodList 

get_interf ace_IRP_operation_prof ile 
( 

in GenericIRPManagementConstDef s : : VersionNumber this_IRP_version 
) 
raises (Get Inter face IRPOper at ionPr of ile, 

OperationNot Supported, 

InvalidParameter, 

ValueNotSupported) ; 

/* 

Return the list of all supported notifications and their supported 

parameters for this Interface IRPVersion. 

*/ 

typedef GenericIRPManagementConstDef s : :Notif icationList Notif icationList ; 

Not if icationList get_interf ace_IRP_notif ication_prof ile 
( 

in GenericIRPManagementConstDef s : : VersionNumber this_IRP_version 
) 

raises (Get Inter face IRPNot if icationPr of ile, 
OperationNot Supported, 
InvalidParameter, 
ValueNotSupported) ; 
}; 



}; 

#endif _GENERICIRPMANAGEMENTSYSTEM_IDL_ 
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